W09-1. ConfigMap · Secret · PV/PVC - 강의 노트
9주차 강의 노트: ConfigMap · Secret · PV/PVC (방명록을 Kubernetes 로 이전)
- 설정을 이미지와 분리해야 하는 이유를 알고, ConfigMap 으로 설정을 넘길 수 있다.
- Secret 의 용도와 한계(암호화가 아니라 인코딩)를 안다.
- PV / PVC / StorageClass 로 데이터를 Pod 밖에 영구 저장하는 구조를 설명할 수 있다.
- 5주차 Compose 의 웹 + DB 를 Kubernetes 로 옮길 수 있다.
진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)
- Service 가 Pod 3개로 요청을 나눠 보내고, Gateway API 로
guestbook.localhost공개 - 문제: 메모리 저장이라 Pod 마다 글이 달랐다 → 오늘 PostgreSQL 로 해결
1. 오늘 만들 구조
5주차 Compose 로 만든 것을 Kubernetes 오브젝트로 옮깁니다.
flowchart TB
U["브라우저
guestbook.localhost"] --> GW["Gateway + HTTPRoute
(8주차)"]
GW --> SVC["Service: guestbook"]
SVC --> W1["방명록 Pod"]
SVC --> W2["방명록 Pod"]
SVC --> W3["방명록 Pod"]
CM["📄 ConfigMap
guestbook-config
DB_HOST, DB_NAME …"] -. "환경 변수" .-> W1
SEC["🔑 Secret
postgres-secret
비밀번호"] -. "환경 변수" .-> W1
W1 & W2 & W3 -- "postgres:5432" --> PSVC["Service: postgres"]
PSVC --> DB["PostgreSQL Pod"]
SEC -. "환경 변수" .-> DB
DB --- PVC["💾 PVC: postgres-data
(1Gi)"]
PVC --- PV["PV (자동 생성)"]| 5주차 Compose | 9주차 Kubernetes |
|---|---|
services: web |
Deployment guestbook + Service guestbook |
services: db |
Deployment postgres + Service postgres |
environment: |
ConfigMap (일반 설정) + Secret (비밀번호) |
.env 의 DB_PASSWORD |
Secret |
volumes: db-data |
PersistentVolumeClaim |
depends_on + healthcheck |
readinessProbe (준비된 Pod 만 Service 에 들어감) |
ports: "8080:8000" |
Service + Gateway/HTTPRoute |
2. 설정을 이미지와 분리하는 이유
| 이미지에 설정을 넣으면 | 설정을 분리하면 |
|---|---|
| 개발 / 테스트 / 운영마다 이미지를 따로 만들어야 함 | 같은 이미지를 환경마다 다른 설정으로 실행 |
| 비밀번호가 이미지 안에 남아 누구나 꺼내 볼 수 있음 | 비밀번호는 클러스터에만 보관 |
| 설정 하나 바꾸려고 다시 빌드 | 설정만 바꾸고 재시작 |
"설정은 환경에 저장하라." 코드와 이미지는 어디서나 같고, 환경마다 다른 값은 환경 변수로 넘긴다. 4주차 ENV + -e, 5주차 .env 가 같은 생각입니다.
3. ConfigMap: 일반 설정
apiVersion: v1
kind: ConfigMap
metadata:
name: guestbook-config
data:
APP_VERSION: "v2-k8s"
DB_HOST: "postgres" # DB 의 Service 이름 (8주차 DNS)
DB_NAME: "guestbook"
DB_USER: "guest"
Pod 에 넘기는 방법:
| 방법 | YAML | 결과 |
|---|---|---|
| 통째로 | envFrom: - configMapRef: name: guestbook-config |
모든 키가 같은 이름의 환경 변수로 |
| 하나씩 | env: - name: X valueFrom: configMapKeyRef: … |
고른 키만 |
| 파일로 | volumes 의 configMap + volumeMounts |
키 = 파일 이름, 값 = 파일 내용 (설정 파일을 통째로 넣을 때) |
환경 변수는 Pod 가 시작될 때 한 번 읽습니다. ConfigMap 을 고친 뒤에는
kubectl rollout restart deployment/guestbook 으로 Pod 를 새로 띄워야 반영됩니다.
(파일로 마운트한 경우는 잠시 뒤 파일 내용이 자동으로 바뀝니다. 앱이 파일을 다시 읽어야 합니다.)
4. Secret: 민감한 설정
apiVersion: v1
kind: Secret
metadata:
name: postgres-secret
type: Opaque
stringData:
POSTGRES_PASSWORD: guestpw # 평문으로 쓰면 저장할 때 base64 로 바꿔 줌
| 항목 | 설명 |
|---|---|
| 쓰는 법 | ConfigMap 과 거의 같음 (secretKeyRef, secretRef) |
stringData vs data |
stringData 는 평문으로 쓰기, data 는 base64 로 인코딩한 값으로 쓰기 |
| 기본 보호 | 권한(RBAC)으로 접근 제한, kubectl get 출력에 값이 바로 보이지 않음 |
실습에서 직접 확인합니다.
$ kubectl get secret postgres-secret -o jsonpath='{.data.POSTGRES_PASSWORD}'
Z3Vlc3Rwdw==
$ ... | base64 --decode
guestpw
base64 는 누구나 되돌릴 수 있습니다. 그래서 실무에서는:
- Secret 이 든 YAML 을 Git 에 그대로 올리지 않습니다.
- 클러스터 저장소(etcd) 암호화를 켜고, RBAC 로 읽을 수 있는 사람을 제한합니다.
- 외부 비밀 저장소(AWS Secrets Manager, HashiCorp Vault 등)와 연동하는 도구(External Secrets Operator 등)나, Git 에 암호화해서 올리는 도구(Sealed Secrets, SOPS)를 씁니다.
$(변수) 로 조합하기
방명록은 DATABASE_URL 하나를 원합니다. ConfigMap 과 Secret 의 값을 조합해서 만듭니다.
envFrom:
- configMapRef:
name: guestbook-config # DB_USER, DB_HOST, DB_NAME …
env:
- name: DB_PASSWORD
valueFrom:
secretKeyRef:
name: postgres-secret
key: POSTGRES_PASSWORD
- name: DATABASE_URL
value: "postgresql://$(DB_USER):$(DB_PASSWORD)@$(DB_HOST):5432/$(DB_NAME)"
실제로 Pod 안에서는
DATABASE_URL=postgresql://guest:guestpw@postgres:5432/guestbook이 됩니다(실습에서 확인).
$(이름)은 앞에서 정의된 환경 변수를 가리킵니다.
5. 데이터 저장: PV · PVC · StorageClass
Pod 는 언제든 지워지고 다른 노드에서 다시 생깁니다. DB 데이터는 Pod 밖의 저장소에 있어야 합니다(3주차 볼륨과 같은 생각).
flowchart LR
P["Pod (PostgreSQL)
/var/lib/postgresql"] -- "volumeMounts" --> C["PVC: postgres-data
'1Gi 필요해요' (요청서)"]
C -- "자동 연결 (Bound)" --> V["PV: pvc-4f9c…
실제 저장 공간"]
SC["StorageClass: standard
(저장소 공급자)"] -- "요청이 오면 PV 를 자동 생성" --> V| 오브젝트 | 역할 | 비유 | 누가 만드나 |
|---|---|---|---|
| PVC (PersistentVolumeClaim) | "이만큼의 저장소가 필요하다" 는 요청서 | 주차권 신청서 | 앱 담당자 (우리) |
| PV (PersistentVolume) | 실제 저장 공간 | 실제 주차 자리 | StorageClass 가 자동으로 (동적 프로비저닝) |
| StorageClass | 어떤 종류의 저장소를 어떻게 만들지 | 주차장 관리 회사 | 클러스터 관리자 / 클라우드 |
| StorageClass 의 실제 예 | 만들어지는 저장소 |
|---|---|
Docker Desktop: standard (local-path) |
노드의 디스크 폴더 |
AWS EKS: gp3 (EBS CSI) |
EBS 볼륨 |
| 다른 클라우드 | 각 클라우드의 블록 스토리지 |
Pending 인 것은 정상
Docker Desktop 의 standard 는 WaitForFirstConsumer 방식이라, PVC 를 쓰는 Pod 가 생길 때 PV 를 만듭니다. 그전에는 Pending 입니다(실제 확인).
accessModes
| 모드 | 의미 |
|---|---|
ReadWriteOnce (RWO) |
노드 하나에서만 읽기·쓰기 (블록 스토리지, DB 에 일반적) |
ReadWriteMany (RWX) |
여러 노드에서 동시에 (NFS, EFS 같은 파일 스토리지) |
ReadOnlyMany (ROX) |
여러 노드에서 읽기만 |
6. DB 를 Kubernetes 에 올릴 때의 주의점
오늘은 Deployment(replicas 1) + PVC 로 PostgreSQL 을 띄웁니다. 배우기 쉬운 가장 단순한 형태입니다.
| 설정 | 이유 |
|---|---|
replicas: 1 |
DB 를 여러 개 띄우면 같은 데이터 폴더를 동시에 써서 데이터가 깨집니다 |
strategy: Recreate |
업데이트할 때 옛 Pod 를 먼저 끄고 새 Pod 를 켭니다. 롤링 업데이트(둘이 잠시 동시에 뜸)는 DB 에 위험 |
readinessProbe: pg_isready |
DB 가 진짜 준비된 뒤에만 Service 로 트래픽이 가게 함 (5주차 healthcheck 와 같은 역할) |
- Kubernetes 안에서 DB 를 운영한다면 StatefulSet(Pod 마다 고정 이름과 전용 PVC) 이나 DB 오퍼레이터(CloudNativePG 등)를 씁니다.
- 많은 경우 클라우드의 관리형 DB(DBaaS: RDS, Cloud DB 등) 를 쓰고, Kubernetes 에는 앱만 올립니다. 백업·이중화·패치를 클라우드가 대신해 주기 때문입니다.
- SA 관점: "DB 를 클러스터 안에 둘지, DBaaS 로 뺄지" 는 설계에서 꼭 결정할 항목입니다.
핵심 요약
9주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① 원칙 설정은 이미지 밖에: 같은 이미지 + 환경별 설정
② ConfigMap 일반 설정 → envFrom / env / 파일 마운트
바꾼 뒤에는 rollout restart 해야 환경 변수에 반영
③ Secret 민감한 설정. base64 인코딩일 뿐 암호화 아님 → Git 금지, RBAC, 외부 비밀 저장소
④ $(변수) ConfigMap + Secret 값을 조합해 DATABASE_URL 생성
⑤ 저장소 PVC(요청서) → StorageClass(공급자)가 PV(실제 공간) 자동 생성 → Bound
⑥ DB 운영 replicas 1 + Recreate + readinessProbe (실무: StatefulSet / 오퍼레이터 / DBaaS)
참고 자료
더 깊이 보고 싶다면 (볼트 내 정리 노트):
- 쿠버네티스 개요4: ConfigMap / Secret / Volume / PV·PVC / StorageClass
- ConfigMap, Secret, PersistentVolume (PV) 및 PersistentVolumeClaim (PVC): 개념 노트
- 쿠버네티스 개요2: StatefulSet
공식 문서:
- ConfigMap: https://kubernetes.io/docs/concepts/configuration/configmap/
- Secret: https://kubernetes.io/docs/concepts/configuration/secret/
- Persistent Volumes: https://kubernetes.io/docs/concepts/storage/persistent-volumes/
- Good practices for Secrets: https://kubernetes.io/docs/concepts/security/secrets-good-practices/